.TH GHOSTLIST.CGI 1 "Version 4.3.13:  7 Jan 2014" "Xymon"
.SH NAME
ghostlist.cgi \- CGI program to view ghost clients
.SH SYNOPSIS
.B "ghostlist.cgi"

.SH DESCRIPTION
\fBghostlist.cgi\fR
is invoked as a CGI script via the ghostlist.sh CGI wrapper.

It generates a listing of the Xymon clients that have reported data
to the Xymon server, but are not listed in the
.I hosts.cfg(5)
file. Data from these clients - called "ghosts" - are ignored, 
since Xymon does not know which webpage to present the data on.

The listing includes the hostname that the client reports with, 
the IP-address where the report came from, and how long ago the
report arrived.

By far the most common reason for hosts showing up here is that
the client uses a hostname without a DNS domain, but the hosts.cfg
file uses the hostname with the DNS domain. Or vice versa. You can
then use a \fBCLIENT\fR setting in the hosts.cfg file to match the
two hostnames together.

.SH OPTIONS
.IP "--env=FILENAME"
Loads the environment defined in FILENAME before executing the CGI script.

.SH "SEE ALSO"
hosts.cfg(5), xymonserver.cfg(5)

